home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / zgbtrs.z / zgbtrs
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. ZZZZGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))                                                          ZZZZGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ZGBTRS - solve a system of linear equations  A * X = B, A**T * X = B, or
  10.      A**H * X = B with a general band matrix A using the LU factorization
  11.      computed by ZGBTRF
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE ZGBTRS( TRANS, N, KL, KU, NRHS, AB, LDAB, IPIV, B, LDB, INFO )
  15.  
  16.          CHARACTER      TRANS
  17.  
  18.          INTEGER        INFO, KL, KU, LDAB, LDB, N, NRHS
  19.  
  20.          INTEGER        IPIV( * )
  21.  
  22.          COMPLEX*16     AB( LDAB, * ), B( LDB, * )
  23.  
  24. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  25.      ZGBTRS solves a system of linear equations
  26.         A * X = B,  A**T * X = B,  or  A**H * X = B with a general band matrix
  27.      A using the LU factorization computed by ZGBTRF.
  28.  
  29.  
  30. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  31.      TRANS   (input) CHARACTER*1
  32.              Specifies the form of the system of equations.  = 'N':  A * X = B
  33.              (No transpose)
  34.              = 'T':  A**T * X = B  (Transpose)
  35.              = 'C':  A**H * X = B  (Conjugate transpose)
  36.  
  37.      N       (input) INTEGER
  38.              The order of the matrix A.  N >= 0.
  39.  
  40.      KL      (input) INTEGER
  41.              The number of subdiagonals within the band of A.  KL >= 0.
  42.  
  43.      KU      (input) INTEGER
  44.              The number of superdiagonals within the band of A.  KU >= 0.
  45.  
  46.      NRHS    (input) INTEGER
  47.              The number of right hand sides, i.e., the number of columns of
  48.              the matrix B.  NRHS >= 0.
  49.  
  50.      AB      (input) COMPLEX*16 array, dimension (LDAB,N)
  51.              Details of the LU factorization of the band matrix A, as computed
  52.              by ZGBTRF.  U is stored as an upper triangular band matrix with
  53.              KL+KU superdiagonals in rows 1 to KL+KU+1, and the multipliers
  54.              used during the factorization are stored in rows KL+KU+2 to
  55.              2*KL+KU+1.
  56.  
  57.      LDAB    (input) INTEGER
  58.              The leading dimension of the array AB.  LDAB >= 2*KL+KU+1.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ZZZZGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))                                                          ZZZZGGGGBBBBTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      IPIV    (input) INTEGER array, dimension (N)
  75.              The pivot indices; for 1 <= i <= N, row i of the matrix was
  76.              interchanged with row IPIV(i).
  77.  
  78.      B       (input/output) COMPLEX*16 array, dimension (LDB,NRHS)
  79.              On entry, the right hand side matrix B.  On exit, the solution
  80.              matrix X.
  81.  
  82.      LDB     (input) INTEGER
  83.              The leading dimension of the array B.  LDB >= max(1,N).
  84.  
  85.      INFO    (output) INTEGER
  86.              = 0:  successful exit
  87.              < 0:  if INFO = -i, the i-th argument had an illegal value
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.